home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / ppanim.doc < prev    next >
Text File  |  1996-09-07  |  4KB  |  111 lines
  1.  
  2.  
  3.                            PPAnim 1.0b User Manual
  4.  
  5.                                  Sep 22, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.    The programs and files in this distribution are freely distributable, but
  13. are also copyright (c) Nico François.  They may be freely distributed as long
  14. as no more than a nominal fee is charged to cover time and copying costs.
  15.    No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.  
  19.    The above is generally known as freeware.
  20.  
  21.    Coverdisks or diskmagazines need written permission of UGA to offer the
  22. Powerpacker utilities or Powerpacker/Reqtools libraries on their disk. For
  23. commercial use please read the copyright file on your original PP disk.
  24.  
  25.  
  26.    If you have suggestions or remarks about this program, or if you find
  27. any bugs, please let me know.
  28.  
  29.    Write to the following address:
  30.  
  31.                                 Nico François
  32.                                 Corbielaan 13
  33.                                 B-3060 Bertem
  34.                                 BELGIUM
  35.  
  36.  
  37. Contents
  38. ========
  39.  
  40. 1. An introduction
  41.  
  42. 2. Usage
  43.  
  44. 3. Features
  45.  
  46.  
  47. 1. An introduction
  48. ==================
  49.  
  50.    PPAnim was written to complement one of my other utilities, PowerPacker
  51. (a command and data cruncher).  It is used to play normal IFF ANIM #5 files or
  52. ANIM files crunched with PowerPacker.  The decrunching is done automatically
  53. so the user does not have to know if a file is crunched or not.  The ANIM #5
  54. format is used by most ANIM generating programs, including DPaint III and
  55. Videoscape 2.0.
  56.  
  57.    PPAnim uses 'powerpacker.library' and 'reqtools.library', so make sure
  58. these are present in your Libs: directory.  Double-click 'Install_libs' for
  59. an automatic installation.
  60.  
  61.    If you haven't got PowerPacker you are of course missing one of the main
  62. features of this program.  PowerPacker is available as shareware (up to
  63. version 2.3b) or as a commercial program (version 4.0a).  Order a copy from
  64. UGA, P.O.Box 881, 3700 AW Zeist, The Netherlands.  The commercial version
  65. offers several enhancements like 40 to 50 times faster crunching, overlay
  66. support, an ARexx port, and much more.
  67.  
  68.  
  69. 2. Usage
  70. ========
  71.  
  72.    PPAnim can be used in four different ways.
  73.  
  74. - First of all via the CLI:
  75.  
  76.    If you enter 'PPAnim ?' will get a usage template.  You use PPAnim like
  77. this:
  78.  
  79.    PPAnim [-h] [-j#] [-l#] [-r[#]] [-i] [-o] [<file|dir>]
  80.  
  81.    The program will by default load the ANIM file and play it in a loop.
  82. If the file was crunched using PowerPacker 2.0 or higher PPAnim will first
  83. decrunch it for you.  If the file was encrypted you will be prompted for the
  84. password.
  85.  
  86.    If you enter PPAnim without options, you will be presented with a file
  87. requester.  Entering PPAnim with a directory instead of a file as an argument
  88. will also get you a file requester, but it will be positioned in the directory
  89. you specified.
  90.  
  91.    PPAnim has several options:
  92.  
  93.      -h   :  This option is used to force HAM mode when no CAMG chunk is
  94.              found.  If you don't specify this option PPAnim will assume a
  95.              6 plane screen is extra-halfbrite.  (Note that it is wrong for
  96.              an Amiga IFF ANIM file not to have a CAMG chunk, especially
  97.              when there can be doubt about what display mode to pick!)
  98.      -j#  :  Set a delay between frames in jiffies.  A jiffie is 1/50s (PAL)
  99.              or 1/60s (NTSC).
  100.      -l#  :  Set number of times to loop.
  101.      -r[#]:  Select repeat mode instead of loop mode (see below) and
  102.              (optionally) set number of repeats.
  103.      -i   :  Force screen to be interlaced.
  104.      -o   :  Play the animation once, no loop (same as -l1 or -r1).
  105.  
  106.    The difference between loop mode and repeat mode is the following: in
  107. loop mode PPAnim expects the last two frames of the animation to be the same
  108. as the first two frames, this makes looping easy and above all fast (DPaint
  109. saves animations like this).  Some animations are not like this however and
  110. if you want these to loop correctly you must select repeat mode (-r), PPAnim
  111. will